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ABSTRACT 


f 

The Document Control System (DCS) described in this report 
was developed to provide the Combined Arms Studies and Analysis 
Activity with an automated system for controlling, maintaining, 
and locating the various documents located within the Activity. 
The system was originally designed for the TEKTRONIX 4051, but 
the ever increasing number of documents soon became over- 
burdening resulting in excessive retrieval time. The present 
system represents a conversion to the CDC 6500 utilizing the 
existing data management system, System 2000. This report 
contains a general description of the system's structure and 
capabilities, a user's manual, a programmer's manual, and a 
glossary of keywords. 
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CHAPTER 1 
INTRODUCTION 
1-1. PURPOSE. The purpose of the Document Control System (DCS) is to provide 
Combined Arms Studies and Analysis Activity (CASAA) with an automated storage 
and retrieval system for controlling and rapidly locating the various classified 
and unclassified documents located within the activity. 


T-2. BACKGROUND. 


=~s- 


a. The Automated Document Control System utilizing the TEKTRONIX 4051 with 
, flexible disks as the storage medium, though effective and a considerable 

| improvement over its forerunner, had some relatively serious shortcomings. Is 
Foremost of these, due to the ever increasing number of documents, was poor 

retrieval time. Secondarily, accessibility/prioritization and convenience were 
| problems of note, the former due to limited hardware and the latter due to the e 
location of that hardware in a classified area. cf 


b. The negation of the preceding shortcomings, along with cost minimization, 6 
became the objective of the present system. The far superior capabilities of 4 
the CDC 6500 supplemented by the existing data management system software ! 
package (System 2000) seemed the approach to meet the objective requirements. 4 
Such a conversfon would mean considerable retrieval time reduction, multiple | 
access capability, and be as convenient as the nearest terminal capable of zy 
interfacing with the CDC 6500. 4 


c. An additional objective was to provide the individual analyst with 
document search capabilities independent of the Data Management Branch without 
threat of accidental damage to the data base. Since interfacing with System 2000 
would require knowledge of several system language commands, and could threaten 
the desired security, additional programming was required. A program was written 
to prompt the user for information regarding a document search. Another was | 
written to link the prompting program with System 2000. Still others were ; 
written to (1) facilitate input via a prompting program, (2) provide update ie 
capabilities, and (3) produce pertinent hardcopy reports. 


1-3. OVERVIEW. : 


a. Figure 1 presents a general schematic of the Document Contro! System. | 
This figure will be used to describe in further detail how the system was - 
designed to operate. Each of the blocks wil! be explained in logical order 3 
according to the necessary processing. | 


(1) Block number 1 represents a document coming to the Document 
Custodian. It may be a new document, a document to be destroyed, or one that 
is being transferred from one branch to another. In any case, for the system 
to function properly, it 1s absolutely essential that the document go to the 
Document Custodian for processing. 


T-1 


' s : , ee is fo PS ok, 3 
si: ‘ 7 ag? : aes: RPA Se Tagty yee ts as Seam 


" INCOMING 
DOCUMENT 


: DELETE DESTROY 
"RECORD FROM 
MASTERJ FILE 


REQUIRED 


TRANSFER HANGE Loca 
TION CODE 


7. 
PREPARE 
FOLDER 


5. PHYSICAL 
TRANSFER 
OF 


* DESTROY 
DOCUMENT 


DOCUMENT 


8. ABSTRACT 
INFOQ FROM 
DOCUMENT 


CREATE 
RECORD 


P+ NEW 


i2. 13 


CRT wo SEARCH HARDCOPY 
DISPLAY “OR SORT LISTINGS 


Figure 1. General schematic of the Document Control System 
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(2) In block 2 the Document Custodian must decide on the required action. 


Assume that the document is outdated or irrelevant and should be destroyed. In 
that case the next step is block 3. 


' (3) The document record must first be deleted from the master file, 
which contains the records of all the documents in the system. This step can be 
accomplished with a subprogram described later. 


(4) The document must then be destroyed (block 4). If classified, it 
will be shredded by the Document Custodian. 


(5) Assume, however, that the document is only being transferred between 
branches. (In this case it is imperative that the document go to the Document 
Custodian first. If this is not tone; the system will not function.) The com- 
puter terminal will be used to change the location code for that document in the 
data base (block 5). 


(oI The Document Custodian will then physically transfer the document 
block 6). 


(7) If the incoming document is a new document, it will be necessary to 
enter it into the system. The Document Custodian will prepare a manila folder 
in which to place the document (block 7). This folder will accompany the docu- 
ment for the entire time that it remains active within the activity. If the 
document is transferred between branches, the folder must accompany it. 


(8) Certain information is extracted from the document and written down 
on work sheets. This information will be used to create a new record to be 
placed in the data base (blocks 8 and 9). A discussion of the information that 
fs entered into the data base is presented in paragraph 1-4. 


(9) The work sheet is then used to enter the document information into 
the data base via the computer terminal (block 10). 


(10) The document records comprising the data base are stored on 
disks. The programs for updating and using the data base are also stored on CDC. 


(11) The OCS search program can be used to search through the master file 
for specific key words, authors, subject areas, etc. (block 11), and the results 
of the search can be either displayed on the CRT screen (block 12), which fs 
integral to the keyboard, or the documents may be printed out in hardcopy form 
using a line printer (block 13). 


1-4. DOCUMENT COMPONENTS. 


a. The present Document Control System contains 12 types of data regarding 
each document. The following is a summary of the data base definition by com- 
ponent with format specifications. (The actual data base definition resides, as 
created, in System 2000 and is shown in figure 2.) 
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Figure 2. Component listing as defined in System 2000 
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Component Format 


Document Number 1-4 digits 
Title 1-72 ch. 
Author 1-30 ch. 
Location 1-30 ch. 
Year of Publication 2 digits 
Classification 1 ch. 
Downgrade Date 2 ch. 

Date Entered 7 ch. 
Functional Area Code 2 digits 
Initializing Agency 1-20 ch. 
Keyboards 1-20 ch. each 
Abstract unlimited 


b. A more detafled description of each component follows: 


(1) Document number - four-digit number uniquely identifying the 
document. 


(2) Title - first 72 characters of the document title. 


(3) Author - author's surname only; if more than one author, the sur- 
name of the first author listed. 


(4) Location - identification number of the safe where the document 
can be found. 


(5) Year of publication ~ last two digits of the year of publication. 
(6) Classification - one character security code as follows: 


S = Secret 

C = Confidential 

F = For Official Use Only 
U = Unclassified 


(7) Downgrade date - two-character code representing the last two 
digits of the downgrade year, if applicable, or .. if not. 


(8) Date entered - three-letter month abbreviation followed by the 
last two digits of the year entered. Example: Aug 80. 


(9) Functional area code - two digits which serve as a subject matter 
code broken down as follows: 


0}. Fixed Wing Aircraft 

02. Sensors 

03. Tanks 

04. Engineer 

05. Artillery 

06. Tracked Utility Carrier 
07. Tracked Command Post 
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08. Anttfarmor Weapons 
09. Tracked Personnel Carriers 
10. Communications 
11. Ordnance (Conv and Nuclear) 
12. Supply 
13. Air Defense Artillery 
14. Rotary Wing Aircraft 
15. Electronic Warfare 
16. Individual /Crew Served Weapons 
17. Chemical 
18. Medical 
19. Maintenance 
20. Transportation 
21. Command and Control 
_ 22. Air~to-Ground Missiles 
23. Miscellaneous 
24. Scenartos 
25. FMs and TMs 
26. Messages and Correspondence 
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(10) Initializing agency - acronym representing the dispersing agency. 
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(11) Keyword(s) - word(s) considered most indicative of the document 
contents. 


(12) Abstract - summary of the document contents. 
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An example of a typical document printout (full search) 1s shown in figure 3. 
1-5. DOCUMENT REPORTS. 


go ee a 
. 
aT aah ai 


a. System 2000 command strings (subprograms) have been written to produce 
several pertodically required reports. A description of each is presented below: 


(1) Downgrade Report. At the beginning of each calendar year down- 
grading of certain documents is required. A subprogram has been designed to 
search through the data base, extract those documents due for downgrading, and 
produce a computer listing of same. 


(2) Monthly Acquisition Report. This list provides a summary of the 
documents that have been received and entered into the system during any particu- 
lar month. It {1s used to inform activity personnel of new documents that may be 
useful in their study efforts. 


(3) Functional Area Report. To assist CASAA personnel in their litera- 
ture search, this printout will list all documents in CASAA related to a specific 
functional area such as artillery, tanks, etc. Those document records that 
correspond to a selected two-digit functional area code are extracted from the 
document data base and printed out. A complete dump of the record contents is 
made, including the abstract. 


1-6 


ee le wt a step athe ee + zi 


nai pally poten SMM _ Fn et Se eee ee en ~ oe 

5 

Youeas queuNDOp LINZ e& yO ajdwes ‘¢ aunbyy oS | 

| ie 

~ 4 

8 “4 

ae ‘a 

VSLNOY GNY UNTnnGu ed AOMA a  ¥ 

: sUnov eGcUMAsy 4 

bec T Ws aueuMas» ¥ 

SLINN aeOWa¥ du TOSINUD Gad ONYWWOU AUNSWNAUTGHWs SHa ; 

NI S35V4S unl SasGntWwOu etundd oats SOIND V SI WIINGW SIHsa eicdVousut 
: VIOCH e-AIN=90 YNIZIIVILINI 
: $2 #3JU9 Ysov WNUTLINS 
| Ge ANNE ween Acins 30 3410G 
{ °8 weegivl SCV CUNMOU 
; NM e--NULLVVTSISSV IS 
, 99 e--GsaHsl na sti3aa 
olT evGliv00l iAN3gssea 
| VGUH s--cOHINY 
SNOLTsVosa0 4HOnwse StelTt wa wemea tila 


SZeT ee 03 tWAN INSWIYOG 
ZISELTIHGES—#9UT- Ws. 


(4) Inventory (Location) Report. Periodically a printout will? be pro- 
duced for each branch head listing the documents that should be in his branch. 
A physical check can then be made and any discrepancies corrected. 


b. Through System 2000 language commands countless other reports are 
possible. Instead of hardcopy printouts, it is also possible to view report 
findings on a CRT. 
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CHAPTER 2 
DCS CAPABILITIES 
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2-1. PURPOSE. The purpose of this chapter {is to specifically detail some of 
the present system capabilities. Chapter 3 will provide guidance for their 
exploitation. 


2-2. GENERAL. For the Document Control System to serve its purpose, there are 
five basic capabilities it must possess: 


Oo Flexibility 


0 New Document Entry 


0 Document Update 


O Report Generating 
O Document Search 


Of the above, the first three are reserved for Data Management Branch personnel. 
The following sections provide a brief description of each capability. All will 
receive further elaboration in chapter 3. 


} 

2-3. FLEXIBILITY. System 2000 provides the user with a great deal of flexibility . 
in handling data. Programs and subprograms have been written to meet the more I 
frequently occurring needs such as document searches, updating manipulation, and 

report production. However, direct interaction with System 2000 via the system 

language can greatly expand each of these capabilities. For example, it might 
be necessary to-- 


a. Locate all documents written by Doe (author) regarding tanks (keyword) 
or armored vehicles (keyword). 


| 
| 
| 
b. Locate all secret (classification) documents concerning smoke (keyword) | 
published this year (year of publication). 


a i ae ata alee ed eee 2 ad aden 
2 


c. Generate a report of document titles, authors, and location only in 
alphabetical order by title. 


The options are practically only limited by the imagination of the user. Sub- 
programs can easily be created and incorporated into the present system to pro- 
vide the additional desired capabilities. Data Management personnel have suf- 
ficient training to discuss and assist in the creation of the software necessary 
to provide these capabilities. 


= a ee as ie Rm, o 
z A sities pai he hari oe re 
ote 


2-4. NEW DOCUMENT ENTRY. The number of documents maintained in the DCS is con- 

stantly fluctuating. New documents arrive daily and must be evaluated and ; 
appropriately processed. To prevent accidental damage to the data base, this 

capability is reserved for Data Management personnel. As with the search process, 

a prompting program has been written to simplify the input procedure. 


2-1 


2-5. DOCUMENT UPDATE. There are several updating capabilities required to 
insure retrieval of the most recent document data available. The DCS custodian 
must be able to (1) add new data concerning an existing document to the system; 
(2) delete data pertaining to a document from the system; and (3) change data 
such as location or downgrade date as required periodically. Subprograms have 
been created to provide the DCS custodian with these updating capabilities. 


2-6. REPORT GENERATING. As discussed in chapter 1, hardcopy printouts are 
pertodically required for various purposes. The four most common of them 
include (1) Downgrading Report (annually); (2) Monthly Acquisition Report; (3) 
Functional Area Report; and (4) Inventory (Location) Report. Subprograms have 
been created to produce all four reports and options are available to provide 


the user with CRT display or hardcopy printout capabilities. (See also para- 
graph 2-3.) 


2-7. DOCUMENT SEARCH. Obviously the prime function of the Document Control] System 


1s document management. An integral part of this management is the abflity to 
retrieve pertinent information (especially location) by “searching for" a docu- 


ment via some key component. The document search program provides this capability 


for nearly any component and simplifies the procedure by prompting the user for 
the appropriate responses. For example, a user may perform an “author search" 
for all documents written by a specific author. Other searches possible using 
the search program include searching for a document or documents having a 
specific title, document number, keyword(s), initializing agency, location, or 
functional area code. To facilitate this search procedure, a prompting program 
has been created. The user responses are written to output specially formatted 
for System 2000. Hence, the user is capable of interfacing System 2000 and 


the “ig T base with virtually no system language knowledge. (See also para- 
graph 2-3. : 
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CHAPTER 3 
USE OF THE SYSTEM 

3-1. PURPOSE. It is assumed that the user is familiar with basic terminal pro- 
cedures. This chapter represents the user's manual portion of the text. Illus- 
trated in the following sections will be the techniques for utilizing the Docu- 
ment Control System capabilities described in the previous chapter. 
3-2. LOGIN PROCEDURE. A specific login procedure is required to assure the 
legitimacy of the user. The machine prompts are shown in caps and the user 
responses in smal] letters. The x's represent values uniquely assigned to each 
legal user. The yy represents the two-character terminal identification number 
normally associated with that terminal. 

MFA PLEASE LOGIN login 

ENTER USER NAME = xxxx 

XXXXXX ITITI ENTER PASSWORD 

ENTER TASK NAME = xxxxxxx 

ENTER ACN OR CLASS OR SPACE - (hit space bar) 


ENTER TERMINAL NUMBER - yy 


3-3. DOCUMENT SEARCH PROGRAM. This is the most important phase of the Document 
Control System and certainly the most relevant to the individual analyst/user. 


a. Utilization. To utilize the document search program, the user need fssue 
only three commands as follows: 


COMMAND - screen, 80 i 
COMMAND - attach, dcs, id=testpa, mr=1 ; 
COMMAND - begin, search, dcs 


b. The Program. 


(1) The search begins by displaying the “search menu" shown in figure 4. 
The user is prompted to supply the number preceding the menu item about which 
information is known. The smallest number, as prompted, is not necessary, but is 
more restrictive and consequently may limit data selection more precisely to your 
need. For example, if document number 100 was written by Doe, a search for that 
particular document number (item number 1 on the menu) would produce information : 
concerning that one specific document whereas a search for author Doe (item 
gh 3 on the menu) might produce several documents including the one of | 
nterest. 2 


(2) A definition of a "full" and "condensed" search follows the user's 
menu item response (see figure 5) and prompts the user to specify the type in 
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which he is interested. (These definitions appear only in the first search, 
i.e., the first time through the program.) A "full search” will provide a 

listing of all data.available while a "condensed search" will generally pro- 
vide only those ftems necessary to locate and identify the document such as : 
title, location, functional area code, and document number. 


TR ge eng ggg + tee, 


(3) The next prompt is unique depending on which search category the 
user has selected. A listing of these can be seen in figure 6. User response 
to most of the prompts is obvious but a few contain terminology which may ! 
require elaboration. The following is a brief discussion of those. ; 


(a) Title. The 72* which appears after the title prompt jis an : 
indicator aid for the user. The * appears fn column 72. 


(b) Author. The example is correct for multiple authors. List 
only one author's name. 


(c) Keyword(s). The user may search for up to three keywords at 
a time. A “conjunctional search” for keyl and key2 would produce information on 
all documents with both of those keywords. A “disjunctional search" then 
obviously refers to all documents containing etther key] or key2. Examples of a 
"conjunctional" and a "disjunctional" search along with the resulting output can 
be seen in figure 8. (Note the conjunctional search response was negative. ) 


(4) Next the program queries the user as to another search. The number 
of searches is unlimited but machine response is detained until completion of 
the last search. If additional searches are then required, the user need only 
issue BEGIN, SEARCH, DCS, and the program will repeat. 


(5) The program concludes as shown in figure 7. Note: %S will abort a 
System 2000 command, and since the search data is being extracted from System 
2000, should be used instead of %A for that purpose. 


c. Output. The output begins with an abbreviated version of the requested 
search as an {dantifier. This also serves to distinguish between searches if 
several are strung together. The output format appears as in figure 8 (for a 
condensed search) or figure 9 (for a full search). | 


3-4. NEW DOCUMENT ENTRY PROGRAM. This phase of the OCS is reserved for Data 
Management Branch use only to secure against accidental damage to the data base. 


a. Utilization. To input new documents and their accompanying data com- 
ponents, the OCS Custodian {ssues the following two commands: 


attach, dmlib, id=testpa, pw=pete 
begin, input, dmlib 


b. The Program. 


(1) The program begins by supplying the user with the last document 
entered into the system followed by a request for the new entry's number. (See 
figure 10. Note the underlined portion represents user response. ) 
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(2) The first 72 characters of the document title are then prompted 
from the user with an asterisk to indicate the 72nd column. 


(3) The author, location, year published, classification, downgrade 
date, date of entry, functional area code, and initializing agency prompts 
follow and are relatively self-explanatory (see figure 10). 


(4) The custodian is next prompted to enter 1-10 keywords (more may 
be {input via System 2000 commands). This is followed by abstract prompting. 
The abstract is entered as 80 character blocks with "QQ" as the terminator. A 
convenience feature is incorporated providing the custodian with the flexi- 
bility to enter fewer than 80 characters with no ill display effects (see 
figures 10 and 12). 


(5) The program next affords the user an opportunity to check his input 
for errors. If he so chooses, the entries are displayed for inspection and 
change capabilities provided. In figure 1] the user has opted to change the 
document location and then to recheck his entry to illustrate the effect. 


(6) Finally, the user is questioned as to another entry. If affirma- 
tive, the program recycles; if negative, loading information is displayed and 
the user may logout. 


(7) Figure 12 shows the result of a "full search" for the sample docu- 
ment shown in figures 10 and 11. Note in the abstract that, as mentioned in 
subparagraph (4) above, the extraneous blanks after the "5" have been ignored 
resulting in the destred format. 


3-5. SYSTEM 2000 CAPABILITIES. To utilize the DCS search capability as described 
in paragraph 3-3 or the DCS document entry capability just described requires no 
prior knowledge of System 2000. All necessary input is prompted from the user 
and massaged to fit System 2000 input format. However, the remaining sections of 
Chapter 3 will require limited knowledge of System 2000 command language. These 
capabilities could certainly be handled by the same technique as the others, but 
the benefits derivec from machine language communication far outweigh the effort 
required to learn the few basic commands necessary. This is especially evident 
in subparagraph c below. The following subparagraph is reserved for Data Manage- 
ment personnel for obvious reasons, but the other sections are available to any 
user interested in exploiting all ramifications of the system. To access System 
2000, and more specifically the DCS data base, issue the following commands: 


eo s2k, s2k260, id=sys2000 
s 


user, pete % 
dbn is dmlib % 


a. Document Update Routines. There are three types of updating desirable 
to maintain a functional document control system. These, along with the specific 
techniques for their execution, are described in the following subparagraphs. All 


are handied by means of System 2000 subprograms called "strings". To execute 
these subprograms, the user must attach System 2000 and gain access to the DCS 
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data base as explained above. Once linked with the data base, the commands 
described in the following subparagraphs will] accomplish the specified updating. 
For a more in-depth look at the string construction, refer to chapter 4. 

(1) Adding data. Specifically a “string” has been written to aijd new 
keywords to an existing document. Addition to other components is unlikely to 
be necessary though possible as will be discussed in paragraph 3-7. To invoke 
the “string” the user simply issues the following command: 

*C€200 (new keyword, document number) %. 
The first parameter becomes an additional keyword linked to the document number 
corresponding to the second parameter. The "*C200" {is the abbreviated call name 
for the string and the % is the System 2000 terminator. 


(2) Removing data. As with adding data, only the keyword component 
appears to require this flexibility. A keyword is removed as follows: 


*C€210 (old keyword, document number) %. 


The first parameter represents the keyword being deleted from the document whose 
number corresponds to the second parameter. 


(3) Changing data. Several components may require change capability. 
Location, for instance, must be changed regularly to maintain an updated system. 
Classification and downgrade date also require perfodic change. Execution of 
these changes {s {nitfaltzed as follows: 

(a) To change the location of a document-- 
#C€310 (new location, document number) %. 
(b) To change the classification of a document-- 
*C320 (new classi{fication, document number) %. 
(c) To change the downgrade date-- 
*C330 (new date, document number) %. 

(4) Other updating. As previously mentioned, "strings" have been 

created to perform the updates discussed in subparagraph a above. Additional 


updates are only moderately more difficult via System 2000 language commands. 
These will be briefly covered in paragraph 3-7. 


b. Report Generating. The four major reports inherent to the previous 


Document Control System are also provided for in the present system. System 2000 


provides several alternative methods of report production in varying formats. 
The method chosen involves creation of "strings" to produce a default formatted 
listing of all document data available. By handling report generation in the 
same fashion as updating, necessary user knowledge of System 2000 {fs minimized. 
The user has the option of viewing the report results on the CRT or producing a 
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hardcopy printout. The commands described below will produce the appropriate 
report in hardcopy form at DPFO. If the user wishes only to view the report 
findings on the CRT, he may do so by deleting those commands in quotes. 


(1) Downgrade report. 


"Report file is <name> %“ 
*C800 (downgrade date) %. 
"Exit %" 

"Batch, name, print, ID" 


*C800, as mentioned in subparagraph a(1) above, is the abbreviated string call 
name and of course downgrade date js the last two digits of the downgrade year. 
The commands in quotes will be deleted in the following example but are, as 
previously mentioned, necessary to produce a hardcopy printout. 


(2) Monthly acquisition report. 
*C810 (entry date) %. 


The entry date format consists of the three-letter month abbreviation fol lowed 
by the two-digit year abbreviation. 


(3) Functional area report. 
*C820 (functional area code) %. 
(4) Inventory (location) report. 
*C830 (location) %. 


5) Other reports. Producing additional reports is a relatively simple 
task and will be discussed as a portion of the next session. 


c. Flexibility. The flexibility of the DCS is provided by the inherent 
modification capabilities of System 2000. Through some general knowledge of 
System 2000 machine language the user is afforded additional: search, update, and 
gpk aid capabilities. (Update is reserved for Data Management Branch 
use only. 


(1) System 2000 additional search capabilities. Once linked to the data 
base, the following System 2000 commands are useful as supplemental search tools. 
The list will be kept at a minimum, yet substantially improve the user's search 
capabilities. 


(a) DESCRIBE %. This command will provide a listing of the varfous 
components of the data base (see figure 13). The displayed component numbers 
({.e., Cl, C2, ....) will be used as abbreviations representing the corresponding 
components (1.e., document number, title, ....). A list such as Cl, C2, C5, C8, 
C21 is called an “object list" and will be used as a parameter in the print 
command format which follows. 
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Figure 13. Data base definition displayed via “DESCRIBE %" 
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(b) PRINT <object list... .>. The print command displays a 
listing of the data values represented in the "object list." In this manner the 
user may print only that Information tn which he ts interested as opposed to all 
information about a document. Any component number except C20 or C30 jis 
acceptable as part of an “object list." The word “entry” represents an “object 
list" of all components (f.e., prints all data available). 


(c) .. . » WHERE <quantifier clause> %. This phrase completes i 
the print command. The “quantifier clause" allows the user to search more | 
specifically for documents of interest. For example, the search program of 
paragraph 3-3 will allow the user to search for a specific keyword or author, he 
but if both are known, the program does not allow for conjunctional searching | 
across components. By means of the quantifier clause, the user has the ability 
to locate documents by that particular author that also have that specific key- 
word. An example of a “quantifier clause” might look like the following: 


! 
~ « » » Cl EQ 1400 (EQ - EQUALS) ‘ 
- « « « C3 EQ DOE and C21 EQ KEY 1 
~ - » - C1 GT 1400 (GT - GREATER THAN) 


Figure 14 shows several print commands tn thefr entirety accompanied by the 
system response. 


(d) EXIT %. To return to the command mode simply issue the EXIT : 
% command. System 2000 will remain attached and may be recalled by issuing 4 
"S2K", but to issue additional System 2000 commands, the data base will have to \¥ 
again be accessed. q 


(e) %S. Depressing the break or escape key followed by typing %S | 
will abort a System 2000 command. %A performs this function normally, but may, ) 
arta unlikely, cause temporary data base damage if issued while “in System 

000." 


(f) Others. Of course, System 2000 machine language provides many 
additional capabilities including format variations, but these are beyond the 
scope of this manual. 


(2) System 2000 additional update capabilities. Occasionally the DCS 
custodtan may find it necessary to update a component not specifically attended 
to by a “string" (generally due to a typing or read error). These can be 
handled by means of the CHANGE command. Below {fs an example of the CHANGE com- 
mand dat (for obvious reasons this ability is reserved for Data Management 
personnel). 


CHANGE C1 EQ 1300 * WHERE Cl EQ 1299%. ! 


The effect of this issuance would be to change document number 1299 to document 
number 1300. } 


(3) Report generating. If circumstances warrant a need for additional 
hardcopy reports, System 2000 provides that flexibility. Printouts of all or 
partial document information can be created based on whatever criteria are chosen. 

, The procedure is to create a System 2000 "report file" which becomes the system 
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output file and then print that report file. This is done as discussed in 
subparagraph b above by issuing the command “REPORT FILE IS <name> %” and then 
“BATCHing” that file to be printed upon "EXITing" System 2000. The report file 


As a local file it is subject to user perusal as well as all other local file 
user options. 
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ts simply a local file created by System 2000 containing the system response(s). 
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CHAPTER 4 
PROGRAM DOCUMENTATION 
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3 4-1. PURPOSE. It ts assumed that the reader is familiar with both FORTRAN and 
NOS/BE languages. This chapter includes a thorough documentation of the data 

| base definitions including "string" definittons and the FORTRAN prompting pro- 
grams written to simplify system access. Also documented are the control 
Tanguage programs liaising the FORTRAN programs with System 2000. These are 
included as part of the manual in the hope of assisting anyone desiring to 
improve, adapt, or amend the present system. 
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4-2. GENERAL INFORMATION. A great deal of effort was involved in transferring 
and appropriately reformatting data from the previous OMB structured DCS to the 
present DCS which utilizes the CDC 6500 existing data management system, System 
2000. The DATA BASE DEFINITION establishes the hierarchical structure as well 
as size constraints for the basic components of the data base. The STRING 
DEFINITIONS consist of System 2000 language commands providing an abbreviated 
method for execution of those commands. These command strings are the “meat“ 
of the system. The user responses to the FORTRAN PROMPTING PROGRAMS are written 
to a file in the appropriate string format. The CONTROL LANGUAGE PROGRAM then 
attaches System 2000, accesses the DCS data base, and initiates input of the 
newly created file. The previously defined strings called through this file 
then produce the requested output. This technique will be further discussed in 
paragraph 4-4. For ease of reference, a breakout is provided below of the four 
main program listings showing how they are subdivided and where they appear 
within the chapter. DCSREAD and DMLIBINPUT are FORTRAN programs which prompt 
the user for search criteria or data regarding a new document being entered into 
the system respectively. DCS and DMLIB are the related control language programs. 


Figure 

Program Paragraph Program Subdivisions No. Page 

DCSREAD 4-5 Search menu display 18 4-9 

Full and condensed search definition 18 4-10 

Document number search 19 4-11 

| Title search 20 4-12 
| Author search 2] 4-13 
Type of keyword search 22 4-14 
Search for 2 keywords 22 415 

Search for 3 keywords 22 4-16 

Search for 1 keyword 22 4-]7 

Initializing agency search 23 4-18 

Location search 24 4.9 
Functional area code search 25 4-20 

Final informational display 26 4-2] 
ocS 4-6 27 4-22 
OMLIBINPUT 4-7 Input of document no., title 28 4-23 
Input of author, location, publication 

date 28 4-24 
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Figure 
Program Paragraph Program Subdivisions No. Page 
DMLIBINPUT Input of classification, downgrade 
(Cont) date, functional area code, 
initializing agency 28 4-25 
Input of keyword 28 4-26 
Input of abstract 28 4-27 
Entry check routine 29 4-28 
Entry change routine 29 4-29 
Entry change menu display 29 4-30 
Output data/System 2000 command file 30 4-3) 
Output (cont!) and System 2000 
termination 30 4-32 
OMLIB 4-8 31 4-33 


4-3. DATA BASE DEFINITION. The 12 categories of document information maintained 
in the previous DCS were of course preserved in the new. The data base defini- 
tion as shown itn figure 15 relegates numbers to each of these categories estab-~ 
lishing the hierarchical structure inherent to System 2000. System 2000 refers 
to this as the component number. Following the component number is the component 
name. At any time a component may be referenced by either its number or name. 
Following the component name is the component description which establishes the 
type of data and the size constraints (picture designation) of that data. Within 
this picture designation 999 or 9(3) indicates a three-digit integer format while 
XXX or X(3) indicates a character string of three characters. A picture designa- 
tion of RG defines a "repeating group” which represents a repeatable data set 
(1.e., component(s) which may have more than one value). 


4-4, STRING DEFINITIONS. Sequential to defining the data base is the definition 
of any strings the user feels may be useful. These strings, as previously 
mentioned, are an abbreviated means of executing what might be complex System 2000 
commands to produce the desired output. A string is a series of defined characters 
to which the string name (or string component number) refers and which replaces 

the string name (or number) when the latter occurs in a command. For example, if 
a string were defined as follows: 


QOO*SAMPLE (STRING (PRINT Cl, C2, C3 WH Cl EQ 200%)) 
the user could execute the desired print command by simply issuing-- 

*C900 % or *SAMPLE %. 
In either case, the result would be a listing of components one through three 
(document number, title, author) for document number 200. To be more functional 
strings may be written containing variables to be assigned a value upon execution. 
A string like the following: 

QOO*NEW SAMPLE (STRING (PRINT C1, C2, C3 WH Cl EQ *1*%)) 


allows the user to supply the value to replace the variable *]* upon issuance. 
In this manner the user may print components one through three for the document 
of his choice by simply fssuing-- 
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Figure 15. Data base definition 
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*C900 (any document number)% or *SAMPLE (any document number)%. 


a. Figure 16 is a listing of the "search" strings defined for the DCS data 
base. As will be seen in paragraph 4-5, these strings are called to produce 
the requested document search data indirectly by the FORTRAN prompting program 
DCSREAD. 


b. Figure 17 is a listing of the remaining strings defined for the DCS data i 
base. These strings were created to expedite updating and report generating. : 
-The updating strings, 200 through 330, contain multiple variables for which the | 
user must supply values upon execution. Unlike the strings in figure 16, the . 
user must have previously attached System 2000 and accessed the DCS data base 
(DMLIB) to utilize these strings. 


4-5. DOCUMENT SEARCH PROGRAM. The document search program DCSREAD was designed 
to prompt the user for known document information and write that information to 
a file (TAPE 7) formatted as one of the strings discussed in the last paragraph. 
At that point the control ltanguage program DCS takes over providing the link to 
System 2000 (see paragraph 4-6). The following pages contain a copy of the 
entire search program including comment cards to explain each line's function. 
The program is broken down into subroutines corresponding to the known document 
information input. Figure 18 is the initial part of the main program. Following 
that are figures 19 through 26 which contain listings of different subsections 
of the program as determined by the user selected menu number. The document 
number, title, author, keyword, initializing agency, location, and functional 
area code search subroutines can be seen respectively in these figures. 


| 4-6. SEARCH CONTROL LANGUAGE PROGRAM. The control language program OCS pro- 
vides the link between the FORTRAN prompting program in paragraph 4-5 and 
System 2000. The cyber control language allows the mixture of NOS/BE and 
System 2000 commands. Figure 27 lists DCS including comment cards to explain 
each line's function. 


4-7. DCS INPUT PROGRAM. The DCS input program DMLIBINPUT was designed to 
simplify the input of new data for the system custodian. As in DCSREAD, the 
user is prompted to furnish data responses which are written to a file (TAPE 7) 
later to become the data file for the System 2000 data base. As before, this 
data must be specially formatted for System 2000. The control language program 
DMLIB (to be discussed in paragraph 4-8) then links System 2000 with the 
OMLIBINPUT responses. The following pages list the DMLIBINPUT program including 
comments to explain each line's function. The program is divided into three 
sections: Input, Check/Correct, and Output (figures 28 through 30 respectively). 


4-8. INPUT CONTROL LANGUAGE PROGRAM. The control language program DMLIB pro- 
vides the link between the FORTRAN prompting program in paragraph 4-7 and 
System 2000. Figure 31 lists DMLIB including comment cards to explain each 
Tine’s function. 
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STRING NUMBER(S) 


100 


101 


102 


iil 


112 


121 


131, 133, 135, 137, 139 


130 


132, 134, 134, 138, 140 


151, 152 


461 & 162, 171 & 172 


EXPLANATION 


Produces a listing of all twelve 
categories of information (components) 
as Quantified by another string. 


Calls string 100 to print all components 
for a specific document pupbec. 


Produces a condensed list of information 
for 8 specific document nupbec. 


Calls string 100 to print all components 
for specific document tifle. 


Produces a condensed list of information 
for a specific document fitle. 


Calls string 100 to print all components 
for any document written by a specific 
author. 


Call string 100 to print all components 
for any documents containing all of the 
specified keywords (131, 133, 137) or 
any of the specified keywords (135, 139). 


Produces a specially formatted listing 
of components 1, 2, 4 and 9 (i.e. 
document number, title, location and 
functional area code) as quantified by 
another string. 


Call string 130 to print the condensed 
listing described above for any 
documents containing all of the 
specified keywords (132, 134, 138) or 
any of the specified keywords. 

(136, 140). 


Call strings 100 or 130 to produce a 
complete or partial listing of 
components respectively, for any 
document initialized by a specific 
agency. 


Mimic strings 151 and 152 for any 
document in a specific lecation or 
categorized under a certain functicnal 
area respectively. 


Figure 16. String definitions related to search program DCSREAD (concluded) 
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CHAPTER 5 
KEYWORD LIST 


5-1. PURPOSE. Searching for a document via related keywords represents the 
most common type of document search. Obviously, to be functional, the keyword 
list cannot remain static. Keyword values uniquely descriptive of a document 
must be added. It is essential to system improvement that input in this regard 
come from the user. DMB notification of such a keyword deficiency will result 
In a more beneficial system for all. Figure 32 contains the entire keyword list 
at the time of the DCS conversion. This list is provided as an afd to both user 
and custodian. The user can reference the list to determine which keywords 
would most closely relate to the document of interest as well as the exact 
syntax. The custodian can use the listing to maintain a functional, yet minimal, 
number of keywords while inputting new document information. The keywords are 
listed alphabetically and are preceded by the number of documents to which that 
keyword relates. 
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